home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / os2 / pmlpp140.zip / pmlpp.hlp (.txt) < prev    next >
OS/2 Help File  |  1997-08-14  |  9KB  |  209 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Legal Notice ΓòÉΓòÉΓòÉ
  3.  
  4. Copyright (C) 1997 James R. Louvau This program is free software; you can 
  5. redistribute it and/or modify it under the terms of the GNU General Public 
  6. License as published by the Free Software Foundation; either version 2 of the 
  7. License, or (at your option) any later version. This program is distributed in 
  8. the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the 
  9. implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See 
  10. the GNU General Public License for more details. You should have received a 
  11. copy of the GNU General Public License along with this program; if not, write 
  12. to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 
  13. 02111-1307, USA. You may contact the author of PMLPP at: E-mail : jim@vwm.com 
  14. Snail-mail : Jim Louvau 3437 335th St. West Des Moines, IA 50266 
  15.  
  16.  
  17. ΓòÉΓòÉΓòÉ 2. Overview ΓòÉΓòÉΓòÉ
  18.  
  19. PMLPP's main window consists of three main elements: 
  20.  
  21.    1. A pushbutton/icon. 
  22.  
  23.    2. A message-count display window. 
  24.  
  25.    3. A popup/context menu. 
  26.  
  27.  Note:  You can drag the main window by clicking and holding either mouse 
  28.  button. 
  29.  
  30.  
  31. ΓòÉΓòÉΓòÉ 2.1. Refresh Button ΓòÉΓòÉΓòÉ
  32.  
  33. Clicking on the refresh button results in one of two actions. If you have 
  34. defined a mailreader, and there is mail pending, PMLPP will attempt to launch 
  35. your reader. Failing that, PMLPP will poll the server immediately if possible. 
  36. The icon background of the button will also reflect PMLPP's current status. If 
  37. the background is GRAY, there is no mail on the server. If GREEN, one or more 
  38. messages are available. If RED, something has malfunctioned (see Error Codes). 
  39.  
  40.  
  41. ΓòÉΓòÉΓòÉ 2.2. Message Count Window ΓòÉΓòÉΓòÉ
  42.  
  43. This is the small window below the refresh/icon button. One of two things will 
  44. appear here; a message count as of the last poll, or an error code. 
  45.  
  46.  
  47. ΓòÉΓòÉΓòÉ 2.3. Context Menu ΓòÉΓòÉΓòÉ
  48.  
  49. PMLPP uses a combination system and context/popup menu. Clicking the 
  50. context-menu mouse button (usually button 2 or the right one) anywhere over the 
  51. main window will bring up the menu. Use the "Properties" option to open a 
  52. configuration dialog. 
  53.  
  54.  
  55. ΓòÉΓòÉΓòÉ 3. Configuration ΓòÉΓòÉΓòÉ
  56.  
  57. The following options are available for configuring PMLPP: 
  58.  
  59.       Play Sound. 
  60.  
  61.       Minutes. 
  62.  
  63.       Server. 
  64.  
  65.       Port. 
  66.  
  67.       User. 
  68.  
  69.       Password. 
  70.  
  71.       Program. 
  72.  
  73.       Options. 
  74.  
  75.       Directory. 
  76.  
  77.  
  78. ΓòÉΓòÉΓòÉ 3.1. Play Sound ΓòÉΓòÉΓòÉ
  79.  
  80. If this box is checked, PMLPP will beep ONCE when it detects the first message; 
  81. i.e., when the message count changes from 0 (zero) to 1 (one). 
  82.  
  83.  
  84. ΓòÉΓòÉΓòÉ 3.2. Seconds ΓòÉΓòÉΓòÉ
  85.  
  86. "Click" on the arrow-buttons or type in the number of SECONDS PMLPP should 
  87. pause between polls to the pop server. 
  88.  
  89. Note:  The valid range is 1 to 86400 (24 hours). 
  90.  
  91.  
  92. ΓòÉΓòÉΓòÉ 3.3. Server ΓòÉΓòÉΓòÉ
  93.  
  94. Your pop server's address as a domain name like: 
  95.  
  96. mail.mydomain.com
  97. or as an I.P. address like: 
  98.  
  99. 167.142.225.5
  100.  
  101.  
  102. ΓòÉΓòÉΓòÉ 3.4. Port ΓòÉΓòÉΓòÉ
  103.  
  104. The POP3 "service" port (usually 110). 
  105.  
  106. Note:  If set to 0 (zero), PMLPP will look up the appropriate value in your 
  107. host's "services" file. This is your best bet for staying out of trouble. 
  108.  
  109.  
  110. ΓòÉΓòÉΓòÉ 3.5. User ΓòÉΓòÉΓòÉ
  111.  
  112. You, silly! The name you use to logon to the pop server. 
  113.  
  114. CAUTION:
  115. Your user name is almost always CASE SENSITIVE! 
  116.  
  117.  
  118. ΓòÉΓòÉΓòÉ 3.6. Password ΓòÉΓòÉΓòÉ
  119.  
  120. The password you use to logon to the pop server. 
  121.  
  122. CAUTION:
  123. As with your user name, passwords are almost always CASE SENSITIVE! 
  124.  
  125.  
  126. ΓòÉΓòÉΓòÉ 3.7. Save Password ΓòÉΓòÉΓòÉ
  127.  
  128. If this box is checked, PMLPP will save your password in its INI file, where 
  129. somebody could conceivably see it (INI files are binary, but text in strings is 
  130. visible). If left unchecked, you will be prompted for your password when PMLPP 
  131. is launched. 
  132.  
  133.  
  134. ΓòÉΓòÉΓòÉ 3.8. Force IP ΓòÉΓòÉΓòÉ
  135.  
  136. If this box is checked, and you have entered a (numerically) valid I.P. address 
  137. in the server field, PMLPP will ignore any errors returned from DNS lookup, and 
  138. attempt to use this I.P. address. In other words, YOU are assuming 
  139. responsibility for the correctness of the address. 
  140.  
  141.  
  142. ΓòÉΓòÉΓòÉ 3.9. Program ΓòÉΓòÉΓòÉ
  143.  
  144. The pathname of your mail-reader program. You only need to set this if you 
  145. would like to be able to launch your mail-reader from PMLPP's menu. 
  146.  
  147.  
  148. ΓòÉΓòÉΓòÉ 3.10. Options ΓòÉΓòÉΓòÉ
  149.  
  150. Command-line option to pass to the reader, if any. 
  151.  
  152.  
  153. ΓòÉΓòÉΓòÉ 3.11. Directory ΓòÉΓòÉΓòÉ
  154.  
  155. What directory to change to before running the reader. 
  156.  
  157.  
  158. ΓòÉΓòÉΓòÉ 4. Error Codes ΓòÉΓòÉΓòÉ
  159.  
  160. The following codes may appear in the "message count" window: 
  161.  
  162.  ADDR 
  163.  
  164.            PMLPP was unable to resolve the server name/address (gethostbyname() 
  165.            and/or gethostbyaddr() failed). 
  166.  
  167.  SOCK 
  168.  
  169.            PMLPP was unable to obtain a new socket from the system (socket() 
  170.            failed). 
  171.  
  172.  CONN 
  173.  
  174.            PMLPP was unable to connect to the server (connect() failed). 
  175.  
  176.  SRVR 
  177.  
  178.            The server won't talk to PMLPP. It isn't running, or for some reason 
  179.            (it's too busy, etc.) refuses to accept commands (we timed out 
  180.            waiting for it to "talk" to us, or the server didn't respond with 
  181.            "+OK"). 
  182.  
  183.  USER 
  184.  
  185.            The server has rejected your user name; i.e., it doesn't like you or 
  186.            doesn't know who you are. Make sure you've configured your name 
  187.            correctly. 
  188.  
  189.  PASS 
  190.  
  191.            The server has rejected your password. Make sure you've entered it 
  192.            correctly. 
  193.  
  194.  STAT 
  195.  
  196.            The server doesn't want to give us statistics. You should NEVER see 
  197.            this, and if you do, it probably means something on the server end 
  198.            is broken. 
  199.  
  200.  VALU 
  201.  
  202.            PMLPP couldn't parse the statistics string returned by the server. 
  203.            You should never see this either. 
  204.  
  205.  
  206.  Note:  Some of the above error codes may appear erroneously if something 
  207.  happens to the connection in mid "conversation." In other words, you might see 
  208.  a "PASS" error if PMLPP was waiting for the server to acknowledge your 
  209.  password, and the connection was suddenly broken.